From 2c8ffef284afd4772b0aa38afdaf2f51775d9bb9 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Tue, 9 Jul 2013 10:07:10 -0400
Subject: [PATCH] Document new environment variables

Explain GDK_SCALE and GDK_DPI_SCALE.
---
 docs/reference/gtk/x11.sgml | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/docs/reference/gtk/x11.sgml b/docs/reference/gtk/x11.sgml
index bb588b1163..5039e8a7ed 100644
--- a/docs/reference/gtk/x11.sgml
+++ b/docs/reference/gtk/x11.sgml
@@ -81,6 +81,31 @@ The X11 GDK backend can be influenced with some additional environment variables
   </para>
 </formalpara>
 
+<formalpara>
+  <title><envar>GDK_SCALE</envar></title>
+
+  <para>
+    Must be set to an integer, typically 2. If set, GDK will scale all
+    windows by the specified factor. Scaled output is meant to be used on
+    high-dpi displays. Normally, GDK will pick up a suitable scale factor
+    for each monitor from the display system. This environment variable
+    allows to override that.
+  </para>
+</formalpara>
+
+<formalpara>
+  <title><envar>GDK_DPI_SCALE</envar></title>
+
+  <para>
+    This can be useful when using scale-aware GTK+ applications together
+    with scale-unaware applications on a high-dpi display. In that case,
+    the font resolution can be doubled to make scale-unaware applications
+    readable, and <envar>GDK_DPI_SCALE=0.5</envar> can be set to compensate
+    for that in GTK+ applications which are already scaled by setting
+    <envar>GDK_SCALE=2</envar>.
+  </para>
+</formalpara>
+
 </refsect2>
 
 </refsect1>
-- 
2.30.2